home *** CD-ROM | disk | FTP | other *** search
/ Aminet 22 / Aminet 22 (1997)(GTI - Schatztruhe)[!][Dec 1997].iso / Aminet / mus / play / DiamondGUI10.lha / DiamondGUI / DiamondGUI.doc < prev    next >
Text File  |  1997-09-18  |  9KB  |  251 lines
  1.  
  2.                       Diamond GUI v1.0 (18.09.1997.)
  3.  
  4.                       (c) 1997 by Dejan Stepanovic
  5.  
  6.  
  7.            MPEGA is an MPEG Audio decoder (Layers I, II & III)
  8.                        (Aminet:mus/play/MPEGA.lha)
  9.                       (c) 1997 by Stephane Tavenard
  10.  
  11.  
  12.  
  13. Distribution conditions:
  14.  
  15.   This program is copyrighted by Dejan Stepanovic.
  16.  
  17.   It may be distributed freely under the condition that no profit is
  18.   gained from its distribution.
  19.  
  20.   It may be put on public domain disks or included in public domain
  21.   program collections only with my permission, nevertheless it must not
  22.   be sold commercially as a single program.
  23.  
  24.   All files that are part of this package have to be distributed
  25.   together and none of them may be changed in any way other than
  26.   archiving or crunching.
  27.  
  28.  
  29. Disclaimer:
  30.  
  31.   Use this program at your own risk. I'm not responsible for any damage
  32.   which it may cause.
  33.  
  34.  
  35. Introduction:
  36.  
  37.   Diamond GUI is a freeware graphic user interface for great MPEGA player
  38.   created by Stephane Tavenard. At this time there are few programs with
  39.   same purpose, but no one fulfills all my demands, so I decided to make
  40.   one which will support more parameters and will be more usable. Current
  41.   version supports version 3.3 of MPEGA.
  42.  
  43.  
  44. Requirements:
  45.  
  46.   - MPEGA v3.3 - can be found on Aminet:mus/play/MPEGA.lha
  47.  
  48.   - Kickstart 2.0+
  49.  
  50.   - DOS command Status in C:
  51.  
  52.   - display fonts (included)
  53.  
  54.   - reqtools.library ((c) by Nico François and Magnus Holmgren; can also
  55.     be found on Aminet)
  56.  
  57.  
  58. Installation:
  59.  
  60.   Copy the program and documentation where ever you want and put the
  61.   included fonts into FONTS: directory.
  62.  
  63.  
  64. Features:
  65.  
  66.   - LCD like display with the most important informations (time, total
  67.     time, status, track name and info...)
  68.  
  69.   - easy controlable playing functions
  70.  
  71.   - main panel selectable playing options
  72.  
  73.   - real-time changing parameters (changing speed, of course, depends on
  74.     priority, processor speed and compression method)
  75.  
  76.   - forward/backward in track positioning via slider with automatic time
  77.     and percentage calculating and displaying
  78.  
  79.   - multitrack selection
  80.  
  81.   - track repeating and random choosing
  82.  
  83.   - preferences window which features other more important MPEGA settings
  84.  
  85.  
  86. Usage:
  87.  
  88.   When you start the program, you will see a window with these
  89.   gadgets/buttons:
  90.  
  91.  
  92.    Play   - Start playing track. If the track is not loaded, it will
  93.             open requester and after selection will start to play it
  94.             automatically. Using this gadget during the play will
  95.             restart the track.
  96.  
  97.    Prev   - Position to the previous track. If you chose more files,
  98.             this function will position program to the previous one.
  99.  
  100.    Next   - Position to the next track. If you chose more files, this
  101.             function will position program to the next one.
  102.  
  103.    Pause  - Pause playing. 'Play' gadget will continue it.
  104.  
  105.    Stop   - Stop playing. Will reset time and percentage counters and
  106.             move slider to the beginning.
  107.  
  108.    Eject  - Eject the current tracks and open requester to select the
  109.             next ones.
  110.  
  111.  
  112.   With the slider at the bottom of the window you can jump to any
  113.   position of the track. Moving it directly with the mouse or clicking
  114.   inside its field can achieve this operation during the reproduction.
  115.   Moving by the arrows operate only in the Stop and Pause mode. In those
  116.   modes time display will be refreshed instantly.
  117.  
  118.  
  119.   Buffer  - Turn the audio buffering on/off. Default buffer size is 1
  120.             but can be changed by the slider in the preferences
  121.             window. When it is turned on it will show current buffer
  122.             status (in seconds) on display so you will be able to see
  123.             when the buffer is full or empty.
  124.  
  125.             [If you have slower machine this option can give you better
  126.             listening quality but requires a huge amount of memory and
  127.             waiting for buffer to be full.]
  128.  
  129.   Stereo  - Turn the stereo mode on/off.
  130.  
  131.   Filter  - Turn the sound filter on/off.
  132.  
  133.   Quality - Choose the output quality (Low, Medium or High)
  134.  
  135.   Frequency - Choose the number by which the track's sampling
  136.   division    frequency will be divided (x1, x2 or x4)
  137.  
  138.   Random  - Play random selected track. In this case 'Next' means 'next
  139.             random track'.
  140.  
  141.   Repeat  - Start playing again after the end of the last track
  142.  
  143.  
  144.   On the right side of the window is the volume scroller. You can set the
  145.   volume value either the track is playing or not.
  146.  
  147.  
  148.   R       - Reset volume scroller to default value (64)
  149.  
  150.   ?       - Just some informations about the author and the current
  151.             version of the program
  152.  
  153.   Prefs   - Open preferences window. I think that most of these options
  154.             are self-explainable and there is no need for special
  155.             descriptions. If you can't understand them, please consult
  156.             MPEGA manual.
  157.  
  158.             'Reset' - Return previously used settings.
  159.  
  160.             'Save'  - Save settings from both windows.
  161.  
  162.             All functions from the preferences window are activated
  163.             immediately after set up. You can reset them until 'Save'
  164.             button is used.
  165.  
  166.  
  167.   IMPORTANT NOTE: If you use MPEGA configuration file, you need to know
  168.                   that its parameters will be called at last, which means
  169.                   that these set by the GUI won't be performed. I could
  170.                   make an empty cfg file and call it every time but think
  171.                   that wouldn't be a proper solution. The best way to
  172.                   handle this is renaming your cfg file and using it with
  173.                   the '-c' option.
  174.  
  175.  
  176. History:
  177.  
  178.   04.08.97.          -  Started coding.
  179.  
  180.   05.08.97.          -  Internal release, actually not really usable.
  181.  
  182.   07.08.97. (v0.2)   -  Fixed some bugs, fixed time measuring, added
  183.                         display, slider and real-time commands. Many other
  184.                         small improvements.
  185.  
  186.   08.08.97. (v0.4)   -  Fixed bugs in display, added 'Frequency division'
  187.                         buttons, fixed slider moving, added 'Quality'
  188.                         buttons, fixed time measuring (now should work
  189.                         okay)
  190.  
  191.   09.08.97. (v0.5)   -  Disabled slider moving by one click while playing,
  192.                         added 'Volume' scroller, added 'Reset volume to
  193.                         default' button, some minor improvements.
  194.  
  195.   10.08.97. (v0.6)   -  Added 'Repeat' button, blinking playing status
  196.  
  197.   12.08.97. (v0.7)   -  Minor changes on display, added multitrack
  198.                         selection, 'Filter' and 'Random' buttons
  199.  
  200.   15.08.97. (v0.8)   -  Buttons redesigned. First public release.
  201.  
  202.   23.08.97. (v0.9)   -  Fixed to work with MPEGA v3.2 (header was changed).
  203.                         Added preferences window and 'Save configuration
  204.                         on exit' button.
  205.                         Added 'Process priority' slider (don't set
  206.                         priority too high because you won't be able to
  207.                         stop the track, or you'll have to wait a lot.
  208.                         Priorities -1 and 0 are the best choices if you
  209.                         have a slower Amiga)
  210.                         Added 'Max. decoding frequency' and 'Audio mixing
  211.                         frequency' sliders. Added 'Default track path'
  212.                         and 'Default MPEGA path' requesters as well.
  213.                         Added 'Save' and 'Reset' buttons and fixed a bug
  214.                         with saving configuration.
  215.  
  216.   18.09.97. (v1.0)   -  Fixed to work with MPEGA v3.3. Some code
  217.                         optimizations. Added input file buffer slider and
  218.                         AHI support (if you don't have AHI installed,
  219.                         option will be disabled). Added audio buffer
  220.                         support. DOS command 'Break' is no longer needed.
  221.  
  222.  
  223.  
  224. To do (soon):
  225.  
  226.   - Support for converting functions
  227.  
  228.   - Playlists with configurable description fields
  229.  
  230.   - Iconify option
  231.  
  232.   - And more...
  233.  
  234.  
  235.  
  236. Greetings to:
  237.  
  238.  - Stephane Tavenard, for making the best MPEG Audio player
  239.  
  240.  - Vlade, for visual design, beta-testing and suggestions
  241.  
  242.  - Amiga for being best computer ever :)
  243.  
  244.  
  245.  
  246. This program is freeware. No donation or usage fee is required, however,
  247. any donations are always appreciated, and can only encourage further
  248. development of the program. If you like it and if you use it, if you have
  249. any comments or suggestions, feel free to contact me at e-mail address:
  250. dexter@afrodita.rcub.bg.ac.yu.
  251.